home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / scanbat.zip / QUICK.DOC < prev    next >
Text File  |  1990-01-11  |  34KB  |  1,099 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     S C A N L O N    E N T E R P R I S E S
  9.  
  10.                   B A T C H     F I L E     U T I L I T I E S
  11.  
  12.                              Version 2.2  (SEBFU)
  13.  
  14.                                    (C) 1989
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                    Q U I C K   R E F E R E N C E   G U I D E
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                  ADD       Syntax : ADD var v
  36.  
  37.        Where  'var'  is any legal Dos variable, previously  assigned  at
  38.        least zero (set var=0) and 'v' is the amount to add to 'var', and
  39.        is in the range of 0 thru 9, with a default value of 1, if 'v' is
  40.        not specified.
  41.  
  42.                  BEEP      Syntax : BEEP [n] [P] [K]
  43.  
  44.        Where 'n' specifies the number of beeps, 'P' causes the beeps  to
  45.        occur  every  second (instead of right away) and 'K'  causes  the
  46.        beeps to occur every second until a key is pressed.
  47.  
  48.                  BIGLTR    Syntax : BIGLTR message, bc fc
  49.  
  50.        Where 'message' is any 10 alpha numeric characters (ascii  values
  51.        in  the  range of 0 thru 255), 'bc' is the background  color  and
  52.        'fc'  the foreground color.  This command will display,  starting
  53.        at the current row and column, any text included in 'message', as
  54.        long  as you do not exceed the 10 character limit.  If  'message'
  55.        is longer than 10 characters, then 'message' will be truncated at
  56.        the  tenth character.  The characters so displayed will be  large
  57.        characters of 9 rows by 8 columns.
  58.  
  59.                  CDCK      Syntax : CDCK
  60.  
  61.        Simply  returns  an  errorlevel  of 1 if  the  CD-Rom  driver  is
  62.        present, else returns an errorlevel of 0.
  63.  
  64.                  CDD       Syntax : CDD n
  65.  
  66.        Where  'n' is the number of directory levels to move  toward  the
  67.        root directory.
  68.  
  69.                  CGABORDR  Syntax : CGABORDR n
  70.  
  71.        Changes the CGA border color to the selected value of 'n'.
  72.  
  73.                  CHGC      Syntax : CHGC sr sc er ec bc fc
  74.  
  75.        Changes   the  screen  colors,  without  affecting   the   screen
  76.        characters, for the selected screen range.
  77.  
  78.        Where  'sr'  is the start row, 'sc' the start  column,  'er'  the
  79.        ending row, 'ec' the ending column, 'bc' the background color and
  80.        'fc' the foreground color.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                                    Page 2
  91.  
  92.  
  93.  
  94.                        Q U I C K    R E F E R E N C E
  95.  
  96.                              SEBFU  Version 2.2
  97.  
  98.  
  99.  
  100.                  CHGLOCK   Syntax : CHGLOCK [C] [N] [S]
  101.  
  102.        Toggles  the  existing  state of the selected  lock  key,  where,
  103.        C=caps  lock, N=num lock and S=Scroll lock.  CHGLOCK without  any
  104.        parameters causes all current settings to reverse (toggle).
  105.  
  106.                  CHKSUM    Syntax : CHKSUM fname n
  107.  
  108.        Where  'fname' is the file to get a check sum for, and 'n' is  an
  109.        optional checksum value to compare the calculated one with.
  110.  
  111.                  CK101
  112.  
  113.        Returns  an errorlevel of 0 if a 101 type keyboard  is  attached,
  114.        providing  the  Rom  Bios supports this  mode,  else  returns  an
  115.        errorlevel of 1.
  116.  
  117.                  CKCLK
  118.  
  119.        Returns  an  errorlevel of 1 if Dos reports the  year  1980  else
  120.        returns  an errorlevel of 0. Use this as a first guess  that  the
  121.        Dos time and date has been set.
  122.  
  123.                  CLR sr sc er ec bc fc
  124.  
  125.        Clears  the screen starting at the specified row 'sr' and  column
  126.        'sc'  thru  row 'er' and column 'ec' using the  specified  colors
  127.        'bc' (background) and 'fc' (foreground).
  128.  
  129.                  CLRKEY
  130.  
  131.        Clears  the type ahead buffer.  Prevents the user  from  entering
  132.        responses in advance of the questions or prompts.
  133.  
  134.                  COFF
  135.  
  136.        Toggles the cursor off on most MGA and CGA systems, but will  NOT
  137.        always work on MGA systems, and won't work on EGA or VGA systems.
  138.  
  139.                  COLOR bc fc
  140.  
  141.        Sets  the  screen colors, providing that ANSI.SYS or  other  ANSI
  142.        driver  has been installed.  The colors are set to  the  selected
  143.        background 'bc' and foreground 'fc' color.  Prior to using  this,
  144.        use our DETANSI function to check for the existence of the driver
  145.  
  146.                  CR
  147.  
  148.        Waits  for the ENTER key to be pressed.  All key  strokes  simply
  149.        cause the speaker to beep.
  150.  
  151.  
  152.  
  153.                                    Page 3
  154.  
  155.  
  156.  
  157.                        Q U I C K    R E F E R E N C E
  158.  
  159.                              SEBFU  Version 2.2
  160.  
  161.  
  162.  
  163.                  CT
  164.  
  165.        Toggles  the cursor on or off, depending upon which state  it  is
  166.        currently in.  CT does NOT work on all systems.
  167.  
  168.                  CUON
  169.  
  170.        Makes the cursor visible.
  171.  
  172.                  CURKEY
  173.  
  174.        Returns  an  errorlevel of 1 thru 4 depending upon which  of  the
  175.        four cursor control keys is pressed.  The four values are :
  176.  
  177.                  1 = up arrow          2 = down arrow
  178.                  3 = left arrow        4 = right arrow
  179.  
  180.        If  the enter key is pressed or escape keys are pressed,  the  an
  181.        errorlevel  of 0 is returned, any other key press will result  in
  182.        the speaker beeping.
  183.  
  184.                  DAYOFMO
  185.  
  186.        Returns  an  errorlevel of 1 thru 31 for the current day  of  the
  187.        month  as  reported by Dos.  Dos must have the correct  time  and
  188.        date for this to function properly.  To determine if the Dos time
  189.        and Date are set, use our CKCLK function.
  190.  
  191.                  DAYOFWK [mm-dd-yy] [D]
  192.  
  193.        In the functions basic format, returns an errorlevel representing
  194.        the  day of week (Sunday = 1 .... Saturday = 7).  In  the  second
  195.        format, the user specifies the date to return the day of week for
  196.        in the format 'mm-dd-yy' and finally the last format returns  the
  197.        day  of month, by appending the letter 'D' (upper or lower  case)
  198.        after the function name.
  199.  
  200.                  DBLBOX sr sc er ec bc fc Pp
  201.  
  202.        Draws  a  double line graphics box starting at row  'sr',  column
  203.        'sc'  and  ending at row 'er' column 'ec', using  the  background
  204.        color 'bc' and foreground color 'fc' on page 'p' (prefixed by the
  205.        P {upper or lower case}).
  206.  
  207.                  DETANSI
  208.  
  209.        Returns an errorlevel of 1 if an ansi device drive is  installed,
  210.        a 0 if an ansi driver is not installed, or a 2 if the video  mode
  211.        is graphics.
  212.  
  213.  
  214.  
  215.  
  216.                                    Page 4
  217.  
  218.  
  219.  
  220.                        Q U I C K    R E F E R E N C E
  221.  
  222.                              SEBFU  Version 2.2
  223.  
  224.  
  225.  
  226.                  DFREE d: [vname]
  227.  
  228.        Returns  an  errorlevel  in  K bytes for  bytes  available  on  a
  229.        selected  drive  'd:', or places the exact value  in  a  selected
  230.        variable 'vname'. The selected drive letter may be upper or lower
  231.        case,  and  must be prefixed with the colon.   Alternately,  will
  232.        return an errorlevel of 0 if an incorrect drive is specified  and
  233.        the  variable  is  not  specified, or a  1  if  the  variable  is
  234.        specified and the selected drive is not available.
  235.  
  236.                  DLINE sr sc l bc fc p S
  237.                  DLINE Pp l S
  238.  
  239.        Draws  a  double  or single line, using  double  or  single  line
  240.        graphics on the video or sends the line to the selected  printer,
  241.        using length 'l', starting on row 'sr' column 'sc' (video), using
  242.        the background color 'bc' and foreground color 'fc' on page 'p'.
  243.  
  244.                  DLST ftype [/Ln] [/Rn] [/Bn] [/Tn] [/E list]
  245.                             [/I list] [/X] [/D] [/Z]
  246.  
  247.        Displays a list of files in the current directory, where :
  248.  
  249.        ftype  is  the type of file(s) to display, and can  use  the  Dos
  250.        wildcards (*.*, ???.???).
  251.  
  252.        /Ln = Left margin of 'n'        /Rn = Right margin of 'n'
  253.        /Bn = Last margin 'n' to use    /Tn = First line to use 'n'
  254.        /E list = exclude list           /I list = include list
  255.        /X = no extensions shown        /D = show directories
  256.        /Z = stop listing at line 'Bn'
  257.  
  258.        Under  normal execution (without the /Z option), if the  list  is
  259.        longer than rows Tn thru Bn then the function halts, waiting  for
  260.        the user to press enter to continue.
  261.  
  262.                  DRVCK d:
  263.  
  264.        Returns an errorlevel of 0 if the specified drive exists, a 1  if
  265.        the  drive does not, or 2 if the drive was not  specified.   This
  266.        does not check to see if a drive is installed, only if the  drive
  267.        is a valid drive.
  268.  
  269.                  DRVLST var
  270.  
  271.        Returns  a  list  of logical drives in the system.  The  list  of
  272.        drives  will be in variable 'var'.  This list is not  limited  to
  273.        physical drives.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.                                    Page 5
  280.  
  281.  
  282.  
  283.                        Q U I C K    R E F E R E N C E
  284.  
  285.                              SEBFU  Version 2.2
  286.  
  287.  
  288.  
  289.                  DSKRDY d:
  290.  
  291.        Returns  an  errorlevel  of  0 if the  drive  is  ready,  with  a
  292.        formatted  disk, an errorlevel of 1 if the drive exists,  but  is
  293.        not ready, 2 if the drive has an unformatted disk installed,  and
  294.        3 if the drive does not exist.
  295.  
  296.  
  297.  
  298.                  ENVSIZE [TL] [L] [T] [TS] [TK] [B] [K] [V] [R]
  299.  
  300.        Returns  an errorlevel based upon the amount of  Dos  environment
  301.        space left or the total environment space size.
  302.  
  303.                  FCHR sr sc er ec bc fc p c
  304.  
  305.        Fills the selected video area with the selected character, where:
  306.  
  307.                  sr = start row        sc = start column
  308.                  er = ending row       ec = ending column
  309.                  bc = background color fc = foreground color
  310.                  p  = video page       c  = fill character
  311.  
  312.        Any  single character entered for 'c' results in  that  character
  313.        being used as the fill pattern, if two or more characters are  in
  314.        the  'c' position, then it is assumed you want to use  a  decimal
  315.        value,  and  may be from 2 to 3 decimal digits (0-9)  ranging  in
  316.        value  from 0 to 255.  For characters with values less  than  10,
  317.        prefix the value with a zero.
  318.  
  319.                  FILES ftype vname /E list /I list
  320.  
  321.        Returns  an errorlevel equal to the number of files of  the  type
  322.        'type'.   User may specify additional file types by using the  /I
  323.        followed  by a list (of up to 10) additional extension types,  or
  324.        may  exclude  file types from a listing when using the  "*"  wild
  325.        card,  by  entering a /E followed by up to  10  extension  types.
  326.        Alternately,  the number of files will be returned in a  selected
  327.        variable.
  328.  
  329.                  FREEM [var] [/E]
  330.  
  331.        Displays  the  amount  of system Ram left for use,  or  sets  the
  332.        variable 'var' to that value, or using the optional '/E'  switch,
  333.        sets the Dos errorlevel equal to the remaining size in 4K  chunks
  334.        or the specified variable to the remaining size in 4K chunks.
  335.  
  336.        EXAMPLE 1:
  337.                  FREEM
  338.  
  339.        Simply displays the amount of ram available for a program.
  340.  
  341.  
  342.                                    Page 6
  343.  
  344.  
  345.  
  346.                        Q U I C K    R E F E R E N C E
  347.  
  348.                              SEBFU  Version 2.2
  349.  
  350.  
  351.  
  352.        EXAMPLE 2:
  353.                  FREEM MEM
  354.  
  355.        Sets the Dos variable 'MEM' equal to the amount of ram available.
  356.  
  357.        EXAMPLE 3:
  358.                  FREEM /E
  359.  
  360.        Sets  the  Dos  errorlevel (readable from a batch  file)  to  the
  361.        amount of ram divided by 4000 (IE...64K =16, 128K=32, etc...)
  362.  
  363.  
  364.                  FSIZE fname vname
  365.  
  366.        Returns  an  errorlevel of 0 thru 255 for the size  of  the  file
  367.        'fname',  or  alternately places the size (in K bytes)  into  the
  368.        variable 'vname'.
  369.  
  370.  
  371.                  FUNKEY
  372.  
  373.        Returns an errorlevel of 1 thru 10 for the 10 function keys,  all
  374.        other key presses cause the speaker to beep.
  375.  
  376.  
  377.                  GALF
  378.  
  379.        Returns  an  errorlevel of 1 thru 26 for any alpha  key  pressed,
  380.        upper or lower case, all other key presses causes the speaker  to
  381.        beep.
  382.  
  383.                  GCURS [R] [Rv] [C] [Cv] [V]
  384.  
  385.        Returns  an errorlevel for either the row or column  position  of
  386.        the  cursor, or alternately places the row /  column  information
  387.        into the variables ROW and COL.
  388.  
  389.                  GDIR
  390.  
  391.        Sets the Dos variable DIR to the current directory path.
  392.  
  393.                  GDRIVE
  394.  
  395.        Returns  an  errorlevel from 0 thru 255 for  the  current  active
  396.        drive, where 0=A, 1=B, etc...
  397.  
  398.                  GETCC [V]
  399.  
  400.        Returns  an  errorlevel  equal to the cursor  column  number,  or
  401.        alternately  places  the  value into a DOS variable  CC,  if  the
  402.        switch V is included on the command line
  403.  
  404.  
  405.                                    Page 7
  406.  
  407.  
  408.  
  409.                        Q U I C K    R E F E R E N C E
  410.  
  411.                              SEBFU  Version 2.2
  412.  
  413.  
  414.  
  415.                  GETCOLR [F] [B]
  416.  
  417.        Returns  an errorlevel equal to the current screen colors,  where
  418.        'F' specifies the foreground and 'B' the background.
  419.  
  420.  
  421.                  GETCR [V]
  422.  
  423.        Returns an errorlevel equal to the current cursor row, or returns
  424.        the value in the variable CR, if the switch V is included on  the
  425.        command line.
  426.  
  427.  
  428.                  GETMCB
  429.  
  430.        Displays a list, showing the current memory usage.
  431.  
  432.  
  433.                  GETNUM [n....]
  434.  
  435.        Returns  an  errorlevel  equal to the value of  the  numeric  key
  436.        pressed,  or  sounds  the speaker if any other  key  is  pressed.
  437.        Alternately,  the  user  may  specify  which  numeric  keys   are
  438.        acceptable.
  439.  
  440.  
  441.                  GETPG
  442.  
  443.        Returns  an errorlevel equal to the active video page.   For  CGA
  444.        systems, this is usually a value between 1 and 4.
  445.  
  446.  
  447.                  GETVER [M] [V]
  448.  
  449.        Returns an errorlevel equal to the current Dos version (0 if  Dos
  450.        version  1.x) or alternately can set the Dos variable VER to  the
  451.        version number.
  452.  
  453.  
  454.                  GMEN [B] [s] [V]
  455.  
  456.        Returns an errorlevel equal to the amount of ram left for use  in
  457.        the  system, where 'B' returns the value in 4K byte chuncks,  's'
  458.        is  a comparision value, and returns an errorlevel of 0 if  equal
  459.        and  1  if  unequal,  'V' places the actual  ram  size  into  the
  460.        variable MEM .
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                                    Page 8
  469.  
  470.  
  471.  
  472.                        Q U I C K    R E F E R E N C E
  473.  
  474.                              SEBFU  Version 2.2
  475.  
  476.  
  477.  
  478.                  GMODE
  479.  
  480.        Returns an errorlevel equal to the current video mode, where :
  481.  
  482.                  0 = CGA 40x25 black & white
  483.                  1 = CGA 40x25 color
  484.                  2 = CGA 80x25 black & white
  485.                  3 = CGA 80x25 color
  486.                  4 = 320x200 4 color graphics mode
  487.                  5 = 320x200 4 color graphics mode (color burst off)
  488.                  6 = 640x200 2 color graphics mode
  489.                  7 = 80x25 Monochrome adapter
  490.                  8 = 160x200 16 color graphics mode (PCjr)
  491.                  9 = 320x200 16 color graphics mode (PCjr)
  492.                 10 = 640x200 4 color graphics mode (PCjr)
  493.                 11 = ?
  494.                 12 = ?
  495.                 13 = 320x200 16 color graphics mode (EGA)
  496.                 14 = 640x200 16 color graphics mode (EGA)
  497.                 15 = 640x350 monochrome graphics mode (EGA)
  498.                 16 = 640x350 4 color graphics mode (EGA)
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                    Page 9
  532.  
  533.  
  534.  
  535.                        Q U I C K    R E F E R E N C E
  536.  
  537.                              SEBFU  Version 2.2
  538.  
  539.  
  540.  
  541.                  INKEY {key_val},/EAZXScCbc,fc
  542.  
  543.        Retrieves single keystrokes, setting the errorlevel to the  ascii
  544.        value of the keystroke, or alternately allows assigning values to
  545.        specific keys, where :
  546.  
  547.                E = echo mode on (echo char entered)
  548.                A = set error level to ascii if no assignment
  549.                Z = set error level to 0 if no assignment
  550.                X = respond to extended keys only
  551.                    Predefined return codes for extended keys are :
  552.                    UP = 1            DOWN = 2         LEFT = 3
  553.                    RIGHT = 4         PAGE UP = 5      PAGE DOWN = 6
  554.                    HOME = 7          END = 8          INSERT = 9
  555.                    DELETE = 9
  556.                    FUNCTION KEYS 1 THRU 10 = 10 THRU 19
  557.                S = set list separator (separator follows the S), default
  558.                    is a comma
  559.                C  =  color, background color  (decimal)  is  immediately
  560.                      after the S, followed by the separator char, then the
  561.                      foreground color
  562.  
  563.                  INSTR s c vname oname [/X]
  564.  
  565.        Searches  for  the  first occurrence of 'c' starting  at  's'  in
  566.        variable  'vname',  to  output  variable  'oname'.   The   search
  567.        character  must  be  specified as a  decimal  value  (IE...65=A),
  568.        unless the switch '/X' is included on the command line.
  569.  
  570.                  INVERT
  571.  
  572.        Swaps the foreground an background colors, of the entire  screen.
  573.        If  the foreground color is greater than 15 then  the  background
  574.        color will blink on Monochrome and CGA systems.
  575.  
  576.                  KEYSTAT
  577.  
  578.        Returns an errorlevel of 0 thru 4, where :
  579.  
  580.                  1 = Scroll lock on                 2 = Num lock on
  581.                  4 = Caps lock on                 0 = All locks off
  582.  
  583.                  LEN vname
  584.  
  585.        Returns  an  errorlevel  equal to the  length  of  the  specified
  586.        variable 'vname', or a zero if the variable does not exist, or is
  587.        not specified.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.                                    Page 10
  595.  
  596.  
  597.  
  598.                        Q U I C K    R E F E R E N C E
  599.  
  600.                              SEBFU  Version 2.2
  601.  
  602.  
  603.  
  604.                  LIMCK
  605.  
  606.        Returns  an  errorlevel of 1 if a LIM driver  is  detected,  else
  607.        returns a zero.
  608.  
  609.                  LINE sr sc l [bc fc] [Pn]
  610.  
  611.        Draws  a line, using single line graphics, starting on row  'sr',
  612.        column  'sc'for  length 'l', using optional background  'bc'  and
  613.        foreground 'fc' colors on the optional page 'Pn'.
  614.  
  615.                  LOCATE sr sc p
  616.  
  617.        Positions the video cursor to the location specified, where  'sr'
  618.        is the row, and 'sc' is the column.  Alternately, the video  page
  619.        may be specified 'p'
  620.  
  621.                  LOGON [O]
  622.  
  623.        Updates  a file (LOGIN.LOG), with login name, time and  date,  or
  624.        alternately, the logout name, time and date.
  625.  
  626.                  LPT1TO2 (or PRNSWAP)
  627.  
  628.        Reassigns  printer port 1 as printer port 2, and printer  port  2
  629.        becomes printer port 1, and may be referred to as the PRN device.
  630.  
  631.                  LST fname
  632.  
  633.        Displays the file 'fname', one page at a time.  The text file may
  634.        be scrolled by pressing either the space bar, or by pressing  the
  635.        enter key.  Scrolling backwards is not allowed.
  636.  
  637.        The utility also returns an errorlevel of 0 if everything was ok,
  638.        and errorlevel of 1 if the file was not found, or and  errorlevel
  639.        of 2 if the file was not specified.
  640.  
  641.        Pressing the escape key at any time exits.
  642.  
  643.                  MIDSTR s l vname oname
  644.  
  645.        Places  a selected portion of the string 'vname' into the  output
  646.        string  'oname', where 's' is the start of the string to  extract
  647.        from  'vname',  and 'l' is the length (number of  characters)  to
  648.        extract, starting at 's'.
  649.  
  650.                  MOUSECK
  651.  
  652.        Returns an errorlevel of 0 if a mouse driver is not detected,  or
  653.        an errorlevel of 1 if it is.
  654.  
  655.  
  656.  
  657.                                    Page 11
  658.  
  659.  
  660.  
  661.                        Q U I C K    R E F E R E N C E
  662.  
  663.                              SEBFU  Version 2.2
  664.  
  665.  
  666.  
  667.                  MOVCUR [U] [D] [L] [R] [n]
  668.  
  669.        Moves the cursor in the desired direction :
  670.  
  671.                  U = up                D = down
  672.                  L = left              R = right
  673.  
  674.        by an optional value of 'n' or the default value of 1.
  675.  
  676.                  PAGE p V
  677.  
  678.        Returns  an errorlevel equal to the current video page,  or  sets
  679.        the  active video page to 'p', or returns the active  video  page
  680.        number  in  the variable PAGE, if the switch V is  found  on  the
  681.        command line.
  682.  
  683.                  PASSWORD [S]
  684.  
  685.        Prompts the user for a password.  The entered password is  hidden
  686.        by  use of inverse video characters as the password  is  entered.
  687.        PASSWORD  allows  3 attempts at the password, then locks  up  the
  688.        system,  forcing the user to reboot.  Alternately, the  user  may
  689.        append  an  'S' after the function name, and after  entering  the
  690.        correct current password, will be prompted for a new password.
  691.  
  692.                  PATHCK name
  693.  
  694.        Checks  for the existence of the directory 'name' in the  current
  695.        directory.  If the directory 'name' exists, an errorlevel of 0 is
  696.        returned,  if 'name' does not exist, then an errorlevel of  1  is
  697.        returned, and if 'name' is not specified, then an errorlevel of 2
  698.        is returned.
  699.  
  700.                  PFF
  701.  
  702.        Sends a form feed to the PRN device (first printer - LPT1).
  703.  
  704.                  PRDY
  705.  
  706.        Returns  an  errorlevel depending upon the status  of  the  first
  707.        printer (PRN or LPT1), where :
  708.  
  709.                  0 = OK                1 = Timed out
  710.                  2 = Gen Failure       3 = No paper
  711.                  4 = Busy              5 = Off line
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.                                    Page 12
  721.  
  722.  
  723.  
  724.                        Q U I C K    R E F E R E N C E
  725.  
  726.                              SEBFU  Version 2.2
  727.  
  728.  
  729.  
  730.                  PRINT message
  731.  
  732.        Sends  the  string 'message' to the PRN (LPT1)  device.   Accepts
  733.        only  input that Dos allows on the command line.  Don't  use  the
  734.        redirectors   '<'  or  '>'  or  pipe  '|',  unless  enclosed   in
  735.        parentheses
  736.  
  737.                  PRINTC n
  738.  
  739.        Prints  the  ascii character represented by the  numeric  decimal
  740.        value 'n', or multiple characters separated by spaces.
  741.  
  742.                  PRINTF name
  743.  
  744.        Sends  any  file, up to 64k bytes, to the  printer.   No  special
  745.        controls are performed.  This is only a convenience to the  user,
  746.        as the Dos COPY command can just as easily be used.
  747.  
  748.                  PRNSET
  749.  
  750.        Performs a hardware reset to the PRN device.
  751.  
  752.                  RESPONSE var bc fc l [N]
  753.  
  754.        Sets  the variable 'var' to the text entered from  the  keyboard,
  755.        using the optional colors for background 'bc' and foreground 'fc'
  756.        but  requires the length to be specified.  'N' is a switch  which
  757.        prevents  keystrokes  from being echoed to the display,  this  is
  758.        useful for use as Password entry.
  759.  
  760.                  SAVEKEY [c] [/n]
  761.  
  762.        Places  keystrokes  'c'  (litteral)  or  '/n'  decimal  into  the
  763.        type-ahead buffer.
  764.  
  765.                  SCROLL sr sc er ec bc fc [D]
  766.  
  767.        Scrolls  a  selected  portion of the screen  up  or  down,  using
  768.        optional colors.
  769.  
  770.                  SCROLMSG [/bc fc l] message
  771.  
  772.        Displays the string 'message' on line 25, scrolling it from right
  773.        to left, optionally, the colors and line may be set.
  774.  
  775.                  SETCUR sr er
  776.  
  777.        Sets  the  cursor  style  to block, or  line,  by  selecting  the
  778.        starting 'sr' and ending 'er' rows for the cursor.
  779.  
  780.  
  781.  
  782.  
  783.                                    Page 13
  784.  
  785.  
  786.  
  787.                        Q U I C K    R E F E R E N C E
  788.  
  789.                              SEBFU  Version 2.2
  790.  
  791.  
  792.  
  793.                  SETDATE mm-dd-yyyy
  794.  
  795.        Sets the Dos date to the specified date of mm-dd-yyyy, where :
  796.  
  797.                  mm = month in two decimal digit format, 01 thru 12
  798.                  dd = day of month in two decimal digit format
  799.                  yyyy = year in 4 decimal digit format
  800.  
  801.        NOTE:  must  use hyphens to separate month and day, and  day  and
  802.        year.
  803.  
  804.                  SETERR n
  805.  
  806.        Sets the batch file errorlevel between 0 and 255 (n).  Great  for
  807.        testing  batch  files  or when you need to  branch  based  on  an
  808.        errorlevel.
  809.  
  810.                  SETIME hh:mm:ss
  811.  
  812.        Sets the Dos time to that specified in the above format, where :
  813.  
  814.                  hh = hours in 2 digit format (00 - 24)
  815.                  mm = minutes in 2 digit format
  816.                  ss = seconds in 2 digit format
  817.  
  818.        NOTE: must use colons to separate the units of time.
  819.  
  820.                  SETMODE n
  821.  
  822.        Sets the video mode to value n, where :
  823.  
  824.                  0 = 40x25 black & white (CGA)
  825.                  1 = 40x25 color (CGA)
  826.                  2 = 80x25 black & white (CGA, EGA & VGA)
  827.                  3 = 80x25 color (CGA, EGA & VGA)
  828.                  4 = 320x200 4 color graphics
  829.                  5 = 320x200 4 color graphics - color burst off
  830.                  6 = 640x200 2 color graphics
  831.                  7 = Monochrome adapter
  832.                  8 = 160x200 16 color graphics - low resolution - PCjr
  833.                  9 = 320x200 16 color graphics - med. resolution - PCjr
  834.                 10 = 640x200 4 color graphics - high resolution - PCjr
  835.                 13 = 320x200 16 color graphics - EGA
  836.                 14 = 640x200 16 color graphics - EGA
  837.                 15 = 640x350 monochrome graphics - EGA
  838.                 16 = 640x350 16 color graphics - EGA
  839.  
  840.                  SETPG p
  841.  
  842.        Sets the active video page to page 'p'.  Page numbers are from  1
  843.        thru 4 for CGA systems.
  844.  
  845.  
  846.                                    Page 14
  847.  
  848.  
  849.  
  850.                        Q U I C K    R E F E R E N C E
  851.  
  852.                              SEBFU  Version 2.2
  853.  
  854.  
  855.  
  856.                  SHOWVAR vname [/XNPpLcRlCbc fc]
  857.  
  858.        Displays  the variable 'vname'.  This can be done, using the  Dos
  859.        echo  command, with the %vname%, but that usage includes  showing
  860.        the variable name (IE... PATH=A:\), while SHOWVAR only shows  the
  861.        actual variable (IE... A:\). The switches are as follows :
  862.  
  863.                  X = center variable on line
  864.                  N = don't issue a line feed / carriage return
  865.                  Pp = Page number 'p'
  866.                  Lc = Left margin at column 'c'
  867.                  Rl = Use line number 'l'
  868.                  Cbc fc = Use background 'bc' and foreground 'fc'
  869.                           colors.  Separate the colors with a space.
  870.  
  871.                  SKEY
  872.  
  873.        Returns  an errorlevel of 0 if no keystroke is waiting,  else  if
  874.        one is ready, then an errorlevel of 1 is returned.
  875.  
  876.        SNGLBOX sr sc er ec bc fc
  877.  
  878.        Draws  a box, using single line graphics, starting at  row  'sr',
  879.        column  'sc'  and  ending at row 'er',  column  'ec',  using  the
  880.        optional colors 'bc' and 'fc' (background an foreground).
  881.  
  882.                  SOUND [d t]
  883.  
  884.        Sounds  the speaker for about 1 second, or for duration  'd'  and
  885.        tone 't'.
  886.  
  887.                  SROWS
  888.  
  889.        Returns an errorlevel equal to the cursor row.
  890.  
  891.                  STRING r c bc fc [/P] [/Sp]
  892.  
  893.        Displays  or prints 'r' number of 'c' characters, where  'r'  and
  894.        'c' are both decimal values.  The background 'bc' and  foreground
  895.        'fc'  colors  may be specified, and specifying  '/P'  will  print
  896.        instead of displaying the string, while using '/Sp' will  display
  897.        the string on the selected video page.
  898.  
  899.                  SUB vname v
  900.  
  901.        Subtracts  the decimal value 'v' from the Dos  variable  'vname',
  902.        where v is a value in the range of 1 thru 9, 1 is the default.
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.                                    Page 15
  910.  
  911.  
  912.  
  913.                        Q U I C K    R E F E R E N C E
  914.  
  915.                              SEBFU  Version 2.2
  916.  
  917.  
  918.  
  919.                  SWIDTH
  920.  
  921.        Returns  an  errorlevel equal to the column width  of  the  video
  922.        system  in use. If your video system is in 80 column  mode,  then
  923.        this would return an errorlevel of 80.
  924.  
  925.                  WAIT n
  926.  
  927.        Pauses  the system for 'n' seconds or milliseconds.  If 'n' is  a
  928.        value  larger  than 9, then the pause is in  milliseconds,  while
  929.        values between 1 and 9 are  in seconds.
  930.  
  931.                  WAITILL hh:mm:ss
  932.  
  933.        Pauses  the system until the specified time.  The specified  time
  934.        must  be in the above format, including the colons.  You may  not
  935.        specify the time as either an hour, or hour and minutes, in other
  936.        words, the time must include hours, minutes and seconds.  If  the
  937.        correct  time  is  not  specified, then an  errorlevel  of  1  is
  938.        returned.
  939.  
  940.                  WAITM n
  941.  
  942.        Pauses the system for 'n' minutes, where n may be a decimal value
  943.        between 1 and 9.
  944.  
  945.                  WHATDAY
  946.  
  947.        Returns an errorlevel between 1 an 7 for the day of week, where :
  948.  
  949.                  1=Sunday              2=Monday
  950.                  3=Tuesday             4=Wednesday
  951.                  5=Thursday            6=Friday
  952.                  7=Saturday
  953.  
  954.                  WHATHR
  955.  
  956.        Returns  an errorlevel equal to the hour of the day, in  24  hour
  957.        format.  IE...2=2AM 14=2PM
  958.  
  959.                  WHATMIN
  960.  
  961.        Returns an errorlevel equal to the current minute.
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.                                    Page 16
  973.  
  974.  
  975.  
  976.                        Q U I C K    R E F E R E N C E
  977.  
  978.                              SEBFU  Version 2.2
  979.  
  980.  
  981.  
  982.                  WHATMO
  983.  
  984.        Returns an errorlevel equal to the current month, where :
  985.  
  986.                  1=January             2=February
  987.                  3=March               4=April
  988.                  5=May                 6=June
  989.                  7=July                8=August
  990.                  9=September          10=October
  991.                 11=November           12=December
  992.  
  993.                  WHATYR
  994.  
  995.        Returns  and errorlevel equal to the number of years since  1980.
  996.        If  the current year is 1988, then this function will  return  an
  997.        errorlevel of 8.
  998.  
  999.                  WRITE /LcRlPpXNCbc fc,message
  1000.                  WRITE message /LcRlPpXNCbc fc
  1001.  
  1002.        Displays the string 'message', using the following options :
  1003.  
  1004.                  Lc = use left margin 'c'
  1005.                  Rl = use line 'l'
  1006.                  Pp = use page 'p'
  1007.                  X  = center on line
  1008.                  N  = no CR/LF at end of line
  1009.                  Cbc fc = color, where :
  1010.                        bc = background
  1011.                        fc = foreground
  1012.  
  1013.        Notice the comma between the message and the switch list, in  the
  1014.        first syntax version, this is required, only in the first syntax.
  1015.  
  1016.                  WRITEF fname [/Pp]
  1017.  
  1018.        Displays file 'fname' (max of 4 kbytes), using the current column
  1019.        position as the left margin, starting at the current line number,
  1020.        using any existing colors as already may be on the display.   The
  1021.        optional page 'p' may be specified with the '/P' switch.
  1022.  
  1023.                  XMSCK
  1024.  
  1025.        Returns  an errorlevel of 1 if an extended memory  device  driver
  1026.        has been installed, else returns an errorlevel of 0.
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.                                    Page 17
  1036.  
  1037.  
  1038.  
  1039.                        Q U I C K    R E F E R E N C E
  1040.  
  1041.                              SEBFU  Version 2.2
  1042.  
  1043.  
  1044.  
  1045.                  YN [message]
  1046.  
  1047.        Returns an error level of 1 if the 'n' key is depressed or a 0 if
  1048.        the 'y' key is depressed.  YN accepts either upper or lower case,
  1049.        and any key depressed but Y or N results in the speaker  beeping.
  1050.        Optionally  a  message may be displayed, at  the  current  cursor
  1051.        position.
  1052.  
  1053.                  YRSINCE yyyy
  1054.  
  1055.        Returns an errorlevel equal to the difference of the current date
  1056.        subtracted from the specified date yyyy.  If the date is  entered
  1057.        as 2 digits, then the century is assumed to be 1900.
  1058.  
  1059.                  YRSTILL yyyy
  1060.  
  1061.        Returns an errorlevel equal to the difference of the current year
  1062.        and the specified year.  If the specified year is 2 digits,  then
  1063.        the year is assumed to be in the 19th century.
  1064.  
  1065.  
  1066.  
  1067.                                   C O L O R S
  1068.  
  1069.        When  specifying  colors  for  any  of  our  functions,  use  the
  1070.        following  guidelines.   These  values may  vary  depending  upon
  1071.        adaptor.
  1072.  
  1073.         0 = Black       1 = Blue         2 = Green        3 = Cyan
  1074.         4 = Red         5 = Magenta      6 = Brown        7 = Gray
  1075.         8 = Dark Gray   9 = Light Blue  10 = Light Green 11 = Light Cyan
  1076.        12 = Light Red  13 = Light Magenta                14 = Yellow
  1077.                        15 = White
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.                                    Page 18
  1099.